A Perl/Tk Package for NEC- 
Based Antenna Design 



Here is some antenna-modeling software 
for Linux/Unix users. You no longer need 
Windows to see your antenna pattern. 



By Bill Walker, W5GFE 



There are many useful programs 
available for modeling antenna 
systems. Among the most popu- 
lar are those developed by Roy 
Lewallen, W7EL. 1 Roy's programs are 
intended for use on machines running 
Microsoft operating systems. 

Other good sources of information 
include "A Beginner's Guide to Using 
Computer Antenna Modeling Pro- 
grams," 2 from L. B. Cebik, W4RNL, 
and "Modeling HF Antennas with 
MININEC— Guidelines and Tips from 
a Code User's Notebook," 3 by John 
Belrose, VE2CV. 

1 Notes appear on page 54. 
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Enter NEC 

If, like me, you're a user of Unix- 
based operating systems, you may 
find the program NEC more to your in- 
terest. 4 There's very useful download- 
able documentation for NEC on the 
Internet. 5 

The NEC program is very versatile. 
It consists of about 9000 lines or so of 
FORTRAN (see Note 4 for a C version). 
To compile the data, you'll need a good 
FORTRAN compiler. If you don't have 
one, check out the GNU project on the 
Internet. 6 

NEC is a complex program. It pro- 
duces output that consists of pages 
and pages of numbers arranged in 
seemingly never-ending columns. 
This may have accounted for its luke- 
warm acceptance in the amateur com- 
munity over the years. 



In an article published on the 
Internet, 7 I described a system of 
Tcl/Tk programs that accepts the vo- 
luminous output otNEC and produces 
a series of graphs which are, to me at 
least, more useful than the numeric 
output of NEC. I find these graphs 
especially helpful when I'm just fid- 
dling with an antenna. 

Although that software proved both 
useful and popular, it suffered from 
several problems — including the fact 
that the Tcl/Tk language needs the 
BLT extension to handle the pro- 
grams. Also, I must confess that 
Tcl/Tk itself isn't the most comfort- 
able language for me, and I was never 
satisfied with the "straight line" code 
produced when writing in Tel /Tk. The 
current effort, written in Perl/Tk, 
seems more robust and satisfactory. 
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Perl/Tk is an extension of the enormously popular Perl 
language (see Notes 8 and 9 for authoritative work). Both 
Perl and the Tk extension are available for most operating 
systems in either binary or source form from the Internet 
(see CPAN at Note 10). I'm using Perl/Tk on SCO Unix 
5.0.4, but many of my students are using it under either 
Linux or Windows NT. One intrepid soul is even running 
it under Windows 981 

Modeling antenna patterns with NEC 

To model antenna patterns with NEC, you must first 
acquire (or compile) a binary version of the program. Try 
the Web page in Note 4 for either source code or binary files. 
While you're at it, you might also try to print the helpful 
documentation from the source in Note 5. 

NEC consists of a single binary file, so installation is easy. 
Just locate it in a convenient place in your search path. NEC 
does produce some intermediate files, so you need to runNEC 
in a directory where you have write permission. The input to 
NEC consists of a series of lines that describe the geometry 
of an antenna and the applied excitation. 

Informally, each element of an antenna consists of a 
straight line. Each element is "tagged" with an integer. The 
two endpoints of each element represented as points withX, 
Y and Z coordinates. An element is further divided into seg- 
ments for calculating currents in each segment. It's also 
possible to specify the radius of wire in the element. The data 
lines that describe elements are called "GW" lines. 

There's usually a GW line for each element of the antenna; 
however, an antenna such as a discone can be described by 
rotating several elements if need be, so that isn't always true. 
Because many who model antennas may wish to use English 
units and NEC requires metric units, it's possible to include 
a "GS" data line that applies a scaling factor to all elements 
of an antenna. This allows the designer to work with any 
convenient unit of measure. 

The end of the physical description of the antenna is 
marked with a "GE 1" data line. Other data lines ("GN" data 
lines) are used to describe the ground under an antenna, and 
the frequency ("FR" data lines) and excitation ("EX" data 
lines) applied to an antenna. Other lines ("LD") can be used 
to indicate termination impedances. 

If you provide a "RP" data line, the program calculates ra- 
diation patterns. Different parameters of the RP line ask for 
E and H fields to be calculated at various angles of azimuth or 
elevation. The W5GFE antenna package expects you to pro- 
vide one of two different RP cards to provide correct input to 
the plotting programs. The "EN" data line indicates the end 
of the input data. For a complete discussion of all the possible 
input lines and parameters, see the NEC documentation. 

Modeling a Rhombic with NEC 

I live on about 40 acres of land in southeastern Okla- 
homa. There's a single diamond-shaped meadow on the 
property that could accommodate a rhombic antenna that 
is 120 feet by 240 feet. If I use telephone poles that can 
place the wires 50 feet in the air, is it worth building that 
rhombic for 20 meters? Table 1 is a NEC data file that 
describes the situation. The four GW lines describe the 
rhombic antenna. The rhombic has four elements. The line 

GW 1 10 -120.0 0.0 50.0 0.0 60.0 50.0 0.01 
describes the first element, which is divided into 10 seg- 
ments. The coordinates of the endpoints are (-120.0, 0.0, 
50.0), as shown in Fig 1. (The 0.01 represents the radius of 
the wire in the element.) 



The figure makes it easy to determine the other three GW 
lines. Because the antenna is measured in feet, we use a GS 
line to scale the entire antenna to metric units. The GE line 
indicates an end to the antenna geometry, while the GN line 
describes the ground. 

Other lines include the FR line (frequency = 14.0 MHz), 
two EX lines (the excitation applied to element 1 and ele- 
ment 2) and two LD lines (describe the 600-£2 termination 
resistors on elements 3 and 4). 

The RP Data Line 

For purposes of the W5GFE antenna package, it's impor- 
tant to use a special RP data line. The RP line included in 
Table 1 asks for an elevation profile (angles 0° to 180°) to 
be computed at a distance of 10 kilometers from the origin. 
This will instruct NEC to provide output the program 
Elevation expects. 

When computing azimuth fields, a different RP line is 
used. If you wish to compute azimuth patterns, use this RP 
line instead: 

RP 1 361 1001 75.0 0.0 0.0 1.0 10000.0 0.00E+00 

The RP line isn't used if you simply want to view the 
antenna. Look at it using either Wires or NECview. 

The Programs 

The programs in the W5GFE antenna package include: 
Azimuth, Elevation, Wires and NECview: 

Azimuth 

The Azimuth program expects to use output from NEC 
where the RP data line is of the form: 
RP 1 361 1001 75.0 0.0 1.0 10000.0 0.00E+00 



Table 1— A NEC data file. 

CM NEC Input File for W5GFE Rhombic 
CE 

GW 1 10 -120.0 0.0 50.0 0.0 60.0 50.0 0.01 
GW 2 10 -120.0 0.0 50.0 0.0 -60.0 50.0 0.01 
GW 3 10 0.0 60.0 50.0 120.0 0.0 50.0 0.01 
GW 4 10 0.0 -60.0 50.0 120.0 0.0 50.0 0.01 
GS 0.3048 
GE 1 

GN 1 0.0 0.0 0.0 0.0 0.0 0.0 

FR 1 14.0 0.0 0.0 0.0 0.0 0.0 

EX 1 1 1.0 0.0 0.0 0.0 0.0 0.0 

EX 2 1 -1 .0 0.0 0.0 0.0 0.0 0.0 

LD 3 10 10 600.0 0.0 0.0 0.0 0.0 0.0 

LD 4 10 10 600.0 0.0 0.0 0.0 0.0 0.0 

RP 180 1 1001 -90.0 0.0 1.0 0.0 10000.0 0.0 

EN 



(0. 60, 50) 




(0, -60, 50) 



Fig 1 — The rhombic antenna. 
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If the output file from NEC were named rhombic. out, the 
command Azimuth rhombic. out would produce four win- 
dows on the screen. Two of the windows display polar plots 
of the azimuth pattern, while a third displays a Cartesian 
plot of the same information. The fourth window provides a 
"fact box" with useful information about the antenna. An ex- 
ample of the Azimuth screen appears in Fig 2. 

Elevation 

The Elevation program expects to use output from NEC 
where the RP data line is of the form: 

RP 180 1 1001 -90.0 0.0 1.0 0.0 10000.0 0.00E+00 

The command Elevation rhombic .out produces four 
windows similar to those from Azimuth, but that contain 
information about elevation patterns. An example of the 
Elevation screen in shown in Fig 3. 

Wires 

Unlike Azimuth or Elevation, Wires uses the NEC input 
file, not the file produced as output by NEC. Wires ignores 



all data lines except the GW lines. Therefore, Wires isn't 
useful for antennas created using rotations (such as "GH" 
or "GR" data lines). 

The Wires program provides three different views (XY 
plane, YZ plane and XZ plane) of the same antenna. The 
corresponding elements of the antenna are colored the 
same in each view. Wires has a file-selection window that 
lets you pick the antenna description you wish to view. 

Wires provides a "static" view of the antenna. Since the 
arrival of the "active" program, NECview, interest in Wires 
seems to have waned considerably. 

NECview 

NECview, like Wires, provides a picture of an antenna by 
reading NEC input files. Unlike Wires, NECview provides 
only a single window. This window has "sliders" that allow 
the antenna to be rotated continuously so you can view it 
from different angles. NECview is visually stimulating and 
seems to catch the imagination of users. It's based quite 
heavily on a program called xNECview by P. T. deBoer. 11 




Currently, NECview only supports the 
GW and the GR data lines. Fig 4 is a 
screen shot of NECview in action with 
the rhombic as an input file. 

Availability 

The entire W5GFE antenna pack- 
age is available via anonymous FTP. 12 

Conclusion 

In an article long ago, 13 I explored 
some propagation effects at VHF. How 
I wish I'd had modeling software such 
asiVECthen! 

If you like to fiddle with antennas, 
the NEC modeling software combined 
with the W5GFE antenna tool kit will 
provide many enjoyable hours at the 
computer and inspire more than a few 
hours on a ladder. It is no longer 
NECessary to "fly by the seat of your 
pants" when designing antennas. 
Enjoy! 

Notes 

1 R. Lewallen, W7EL, W7EL Software, PO 
Box 6658, Beaverton, OR 97007. 



2 L. B. Cebik, W4RNL, "A Beginner's Guide 
to Using Computer Antenna Modeling Pro- 
grams," TheARRL Antenna Compendium, 
Vol 3. 

3 J. Belrose, VE2CV, "Modeling HF Antennas 
with MINIA/EC — Guidelines and Tips from 
a Code User's Notebook," The ARRL An- 
tenna Compendium, Vol 3. 

4 A really useful and rich reference for NEC 
documentation, code and utilities is at 
www.qsl.net/wb6tpu/. 

5 NEC documentation is downloadable from 
members.home.net/nec2/. 

6 The EGCS group merged with the GNU C 
project located at gcc.gnu.org/. Look for 
their C and Fortran compilers at ftp:// 
ftp.freesoftware.com/pub/sourceware/ 
gcc/releases/index.html. 

7 Bill Walker, "Jiffy" Visualization Software 
for NEC-based Antenna Design can be 
downloaded as W5GFE.tar.gz from 
www.qsl.net/wb6tpu/swindex.html. 

8 L. Wall, T. Christiansen and R. Schwartz, 
Programming in Perl, Second Edition 
(Cambridge, Massachusetts: O'Reilly & 
Associates, Inc; www.oreilly.com; 1996). 

9 N. Walsh, Learning Perl/Tk, (O'Reilly & As- 
sociates, 1999). 

10 The Comprehensive Peri Archive Network 
(CPAN) home page is at www.cpan.org/. 

11 P. T. deBoer, pa3fwm@amsat.org, 
ptdeboer@cs.utwente.nl. 



12 The entire software package is available as 
W5GFE2 .tar.gz at www.qsl.net/wb6tpu/ 
swindex.html. 

13 Bill Walker, "Predicting Radio Horizons at 
VHF," QST, June 1978, pp 28-29. 
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Join the effort in developing Spread Spectrum Communications for 
the amateur radio service. Join TAPR and become part of the largest 
packet radio group in the world. TAPR is a non-profit amateur radio 
organization that develops new communications technology, provides 
useful/affordable kits, and promotes the advancement of the amateur art 
through publications, meetings, and standards. Membership includes a 
subscription to the TAPR Packet Status Register quarterly newsletter, 
which provides up-to-date news and user/technical information. Annual 
membership US/Canada/Mexico $20, and outside North America $25. 



TAPR CD-ROM 

Over 600 Megs of Data in 
ISO 9660 format. TAPR 
Software Library: 40 megs 
of software on BBSs, 
Satellites, Switches, TNCs, 
Temiinals, TCP/IP, and more! 
150Megs of APRS Software 
and Maps, RealAudio Files. 
Quicktirne Movies. Mail Archives from TAPR's 
SIGs, and much, much more! 



Wireless Digital Communications: 
Design and Theory 

Finally a book covering a broad 
spectrum of wireless digital subjects in 
one place, written by Tom McDermott, 
N5EG. Topics include: DSP-based 
modem filters, forward-error-correcting 
codes, camertransmissiontyries.datacoots, 
data slicers, clock recovery, matched filters, 
carrier recovery, propagation channel models, 
and much more! Includes a disk! 
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Tucson Amateur Packet Radio 

8987-309 E. Tanque Verde Rd #337 • Tucson. Arizona • 85749-9399 
Office: (940) 383-0000 • fax: (940) 566-2544 • Internet: tapr@tapr.org ww.tapr.org 
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